home *** CD-ROM | disk | FTP | other *** search
/ 1,000+ Great Games / 1_1000 Games.iso / CASINO / POKER20.ZIP / POKER.DOC < prev    next >
Encoding:
Text File  |  1995-10-12  |  15.5 KB  |  348 lines
  1.          ┌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄┐
  2.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  3.  ────────┤▌ G  A  M  E  K  E  E  P  E  R    D  O  O  R  W  A  R  E ▐├────────
  4.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  5.          ├▌▒▒▒▒▒▒▒▒▒  Quality BBS Door Software for Less!  ▒▒▒▒▒▒▒▒▐┤
  6.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  7.          └▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀┘
  8.  
  9.                                 JACKPOT POKER
  10.                                 ~~~~~~~~~~~~~
  11.                                  Version 2.0
  12.  
  13.                     Copyright (c) Steve Sharpe 1993,1995
  14.  
  15. SYSTEM REQUIREMENTS
  16. ~~~~~~~~~~~~~~~~~~~
  17. 1.  Jackpot Poker can be run on any BBS capable of producing the following
  18.     DOOR.SYS drop files:
  19.  
  20.    *  Original "GAP standard" DOOR.SYS (31 line version)
  21.         - for example, Spitfire BBSs use this one!
  22.  
  23.    *  New (currently 52 line) version DOOR.SYS promoted by Raymond Clements
  24.         - for example, PCBoard BBSs use this one!
  25.  
  26. 2.  Jackpot Poker requires ANSI graphics!
  27.  
  28. SYSTEM OPTIONS
  29. ~~~~~~~~~~~~~~
  30. Jackpot Poker supports the use of FOSSIL drivers and non-standard port
  31. addresses.  Refer to the INSTALLATION instructions for more information.
  32.  
  33. FILES CONTAINED IN POKER20.ZIP
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.      POKER20.EXE       <-- The main program
  36.      GAME.CFG          <-- Sample door configuration file
  37.      POKER.DOC         <-- The file you are reading!
  38.      REVISION.DOC      <-- Revision notes
  39.      DOORWARE.DOC      <-- Gamekeeper Doorware list
  40.  
  41. FILES CREATED BY POKER20.EXE
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.      SCORE.FIL         <-- Exit screen score file
  44.    * TOURNMNT.FIL      <-- Poker tournament management file
  45.    * TOURNMNT.PLY      <-- Poker tournament players file
  46.    * TOURNMNT.HST      <-- Poker tournament history file
  47.  
  48. * Registered Versions Only
  49.  
  50. OVERVIEW
  51. ~~~~~~~~
  52. Jackpot Poker is designed to simulate, as closely as possible, a casino-style
  53. $1 video poker machine.  The game uses a standard 52 card deck with no jokers.
  54. Players begin each gaming session with a $50 bankroll.  To begin each hand,
  55. players must deposit 1-5 coins or play 1-5 credits (if available).  The cards
  56. are then dealt by pressing the 'D' key (Exception: if a player deposits 5 coins
  57. or plays 5 credits, the first set of cards are dealt automatically!).  At this
  58. time, players decide whether they wish to hold any cards before the final deal.
  59. Players are allowed to hold 0-5 cards.  Cards are held by pressing the hold
  60. button below each applicable card (keys 1-5).  Finally, the 'D' key is pressed
  61. to receive any additional cards and calculate the results of the hand.  Winning
  62. hands are paid according to the number of coins/credits played and the value of
  63. the winning hand (Refer to the on-line instructions for Las Vegas video poker
  64. machine payoff values).  All payoffs are received as credits, which can be
  65. played directly or redeemed for their cash value (transferred to a player's
  66. bankroll).  The following poker hands win in Jackpot Poker:
  67.  
  68.      HAND                          EXAMPLE
  69.      ~~~~                          ~~~~~~~
  70.      ROYAL FLUSH...................A-K-Q-J-10 (ONE SUIT)
  71.      STRAIGHT FLUSH................2-3-4-5-6  (ONE SUIT)
  72.      4-0F-A-KIND...................8-8-8-8
  73.      FULL HOUSE....................J-J-J-4-4
  74.      FLUSH.........................2-5-6-J-K  (ONE SUIT)
  75.      STRAIGHT......................2-3-4-5-6  (ANY SUITS)
  76.      3-OF-A-KIND...................7-7-7-2-3
  77.      2 PAIRS.......................K-K-4-4-5
  78.      1 PAIR (JACKS OR BETTER)......J-J-7-9-Q
  79.  
  80. The 'HIGHEST BANKROLL IN A SINGLE SESSION' statistics, displayed on the exit
  81. score screen, are calculated on the amount of a player's bankroll only.
  82. Existing credits don't count!  If a player is competing for 'HIGHEST BANKROLL',
  83. they must redeem their credits before quitting the game.  The exit score screen
  84. also shows the last player who received a royal flush, straight flush, or
  85. 4-of-a-kind.
  86.  
  87. Screen Redraw
  88. ~~~~~~~~~~~~~
  89. A screen redraw feature is provided.  Use this feature if telephone line noise
  90. causes erroneous characters to be displayed.
  91.  
  92. INSTALLATION
  93. ~~~~~~~~~~~~
  94. 1.  'Unzip' the file POKER20.ZIP into the directory of your choice.  All
  95. files must remain in the same directory.
  96.  
  97. 2.  Edit the door configuration file (GAME.CFG) according to the CONFIGURATION
  98. FILE section of these instructions using your favorite word processor.  Ensure
  99. you save it as an ASCII text file.
  100.  
  101. 3.  Create or edit the batch file your BBS will use to activate the door.
  102. The main door program name is POKER20.EXE.  For example, if you are running
  103. a Spitfire BBS, you would edit SF.BAT to look similar to the following:
  104.  
  105. :DOOR_A
  106.    REM Place Door A Commands Here
  107.    CD\SF\DOORS\POKER  <-- Change to the Jackpot Poker directory
  108.    POKER20 GAME.CFG   <-- Main program with configuration file argument
  109.    CD\SF              <-- Change back to the Spitfire directory
  110.    GOTO LOOP
  111.  
  112. Installation Notes
  113. ~~~~~~~~~~~~~~~~~~
  114. NON-STANDARD PORT USE:  You may specify the use of non-standard communications
  115. ports with the PORT command.  The syntax for the PORT command is PORT:03E8:5,
  116. where 03E8 represents a different base address and 5 indicates the IRQ.  For
  117. example, the main program line in the example above would be changed to
  118. POKER20 GAME.CFG PORT:03E8:5 to reflect the use of a non-standard comm port.
  119.  
  120. FOSSIL DRIVER USE:  You may specify the use of a FOSSIL driver with the PORT
  121. command added to the main program command line.  The syntax for the PORT
  122. command is PORT:F:P, where F instructs the door to use a FOSSIL driver and P
  123. identifies the port.  For example, the main program line in the example above
  124. would be changed to POKER20 GAME.CFG PORT:F:1 if the SysOp wished to specify
  125. a FOSSIL driver on port 1.
  126.  
  127. NOTE:  The PORT command must be the third command in the main program command
  128. line, if used.  If not used, the door defaults to the use of the 4 standard
  129. communications ports (1-4) by reading the BBS file.
  130.  
  131. CONFIGURATION FILE
  132. ~~~~~~~~~~~~~~~~~~
  133. Entries in the door configuration file must be accurate or the door cannot be
  134. expected to function properly.  Save changes to this file in ASCII text format.
  135. A sample GAME.CFG file is included with the door.  This configuration file can
  136. be named any valid DOS filename but the file structure must be preserved!  Edit
  137. the door configuration file according to the instructions below.  If you are
  138. running a multi-node BBS, simply make 1 copy of the GAME.CFG file for each node,
  139. give each file a unique name, and edit each file.
  140.  
  141. The GAME.CFG file
  142. ~~~~~~~~~~~~~~~~~
  143. Jackpot Poker               <-- Line 1  (See below)
  144. c:\sf\door.sys              <-- Line 2    "     "
  145. The Gamekeeper's Lair       <-- Line 3    "     "
  146. Steve Sharpe                <-- Line 4    "     "
  147. 000000000000                <-- Line 5    "     "
  148. 1                           <-- Line 6    "     "
  149.  
  150. Line 1 - This line reflects the name of the door.  The registration algorithm
  151. is based on some of this data.  DO NOT CHANGE LINE 1!
  152.  
  153. Line 2 - Enter the full path and filename for the DOOR.SYS drop file applicable
  154. to the current node.
  155.  
  156. Line 3 - Enter the name of your BBS.
  157.  
  158. Line 4 - Enter the SysOp's name.
  159.  
  160. Line 5 - Enter 12 zeros if the door is not registered.  Registered users enter
  161. the registration number provided by the author.  Other numbers will prevent
  162. the door from running.
  163.  
  164. Line 6 - Enter 1 if your BBS DOOR.SYS drop file is the original GAP standard
  165. 31 line version.  Enter 2 if your BBS DOOR.SYS is the newer (longer) version
  166. (presently 52 lines).
  167.  
  168. SYSOP KEYS
  169. ~~~~~~~~~~
  170. The following keys assist the SysOp in the management of the door:
  171.  
  172.          F5 - Shell to DOS
  173.          F8 - Return user to system
  174.          F9 - Toggle display on/off
  175.         F10 - Chat mode (ESC to exit)
  176.       ALT H - Toggle between status lines
  177.  
  178. REGISTRATION
  179. ~~~~~~~~~~~~
  180. The registration fee for Jackpot Poker is $10.  The unregistered door
  181. displays "EVALUATION COPY" upon entry and exit.  Please register or remove the
  182. door within 90 days of first use.  As a BBS SysOp, I understand how costly it
  183. can be to register BBS software.  I have purposely kept the cost of registering
  184. Jackpot Poker to a minimum with that thought in mind.  I believe the fee is
  185. quite reasonable, based on the many long hours of programming required.  Upon
  186. receipt of the registration fee, you will be provided with a unique
  187. registration number.  Once you insert the registration number into the GAME.CFG
  188. file, the opening and closing "EVALUATION COPY" message will be replaced with
  189. the following messages:
  190.  
  191. [OPENING MESSAGE]
  192.  
  193.                                 Your BBS name
  194.  
  195.                                   presents
  196.  
  197. [CLOSING MESSAGE]
  198.  
  199.                              Thanks for playing
  200.  
  201.                                Jackpot Poker
  202.  
  203.                                      on
  204.  
  205.                                Your BBS name
  206.  
  207.  
  208. ** Registration also activates a built-in tournament feature described below.
  209.  
  210. JACKPOT POKER TOURNAMENTS
  211. ~~~~~~~~~~~~~~~~~~~~~~~~~
  212. The SysOp can configure Jackpot Poker to run poker tournaments through the use
  213. of special command line arguments.
  214.  
  215. TOURNAMENT SETUP.  To activate a poker tournament, ensure you are at the DOS
  216. prompt in the Jackpot Poker subdirectory.  Type POKER20 TOURNAMENT_SETUP and
  217. press ENTER.  If a tournament is currently running, you will be asked if you
  218. wish to delete it.  Answering no will return you to the DOS prompt.  If you
  219. answer yes to delete the current tournament or a tournament is not currently
  220. running, you will be asked to enter the duration of the new tournament.
  221. Tournaments can run from 1 to 31 days.  Finally, you will be asked if you wish
  222. a new tournament to be started automatically, following the completion of the
  223. current tournament.  If you answer yes, the daily event routine will
  224. automatically establish a new tournament of the same duration.  If you answer
  225. no, the daily event routine will delete tournament files at the completion of
  226. the current tournament, turning off the tournament feature.  To cancel an
  227. existing tournament without starting a new tournament, answer yes to delete the
  228. current tournament and press the Esc key to exit the setup routine.
  229.  
  230. TOURNAMENT EVENT.  If you use the tournament feature, a daily event must be
  231. run to manage the tournament.  The installation is quite simple!  Just edit
  232. your BBS batch file that controls events to include the following 3 lines:
  233.  
  234.   cd\sf\doors\poker         <-- change to the Jackpot Poker subdirectory
  235.   POKER20 TOURNAMENT_EVENT  <-- execute the event with command line argument
  236.   cd\sf                     <-- change back to the BBS subdirectory
  237.  
  238. Then, configure the event to run once each day, preferably near the end of the
  239. day.  The event routine will track the progress of the tournament and post the
  240. results to a tournament history file upon completion of the tournament.  It 
  241. will also reset tournaments or turn off the tournament feature automatically,
  242. depending upon how you configured the automatic reset option.
  243.  
  244. TOURNAMENT DISPLAYS
  245. ~~~~~~~~~~~~~~~~~~~
  246. When a tournament is active, players who have not joined the current tournament
  247. are asked if they wish to join.  Jackpot Poker displays a tournament status
  248. screen at the beginning and end of play.  This screen displays the start date,
  249. duration, current leader, and your bankroll (if you have joined the
  250. tournament).  The exit tournament status screen provides an option to view
  251. tournament history.  The tournament history screen displays the start date,
  252. stop date, winner, and bankroll for the last 10 tournaments.
  253.  
  254. TOURNAMENT RULES
  255. ~~~~~~~~~~~~~~~~
  256. To win a Jackpot Poker Tournament, a player must have the highest cumulative
  257. bankroll at the end of the last day of the tournament!  There are no ties!  If
  258. two or more players have the same bankroll, the player who played last wins
  259. the tournament.  This is also true of the tournament status screen.  If you
  260. are not the current leader but your bankroll matches the current leader's
  261. bankroll, this condition indicates the current leader played more recently
  262. than you!
  263.  
  264. Although players can play Jackpot Poker as often as the SysOp allows, only the
  265. first play session each day affects a player's tournament statistics.
  266. Additional play sessions are not recorded in the tournament database.
  267.  
  268.  
  269. COMMENTS/BUG REPORTS
  270. ~~~~~~~~~~~~~~~~~~~~
  271. I'm interested in all user comments and bug reports.  Please send your comments
  272. to:
  273.  
  274.                                Steve Sharpe
  275.                             1835 Stonetree Dr.
  276.                           Mountain Home, ID 83647
  277.                          E-Mail ssharpe@micron.net
  278.  
  279. CREDITS
  280. ~~~~~~~
  281. Thanks to Mike Carter and Dave Schubert for their valuable contribution of
  282. gaming information used in Jackpot Poker!
  283.  
  284. Thanks to Marty Martinson for his "bug-finding" skills and to Ian Richardson for
  285. multi-node testing!
  286.  
  287.  
  288.                                  Warranty
  289.                                ------------
  290.        This program has been thoroughly tested on a Spitfire 3.3 BBS,
  291.        however, it should perform equally well on any BBS that can
  292.        produce a BBS drop file listed in this documentation.
  293.  
  294.        I make no warranty of any kind, express or implied, including
  295.        without limitation, any warranties of merchantability and/or
  296.        fitness for a particular purpose.  I shall not be held liable for
  297.        any  damages, whether direct, indirect, special or consequential
  298.        arising from a failure  of this program to operate in the manner
  299.        desired by the user.  I shall not be held liable for any damage to
  300.        data or property which may be caused directly or indirectly by the
  301.        use of this program.
  302.  
  303.        In no event will I be held liable for any damages, including (but
  304.        not limited to) any lost profits, lost savings or other incidental
  305.        or consequential damages arising out of the use or inability to
  306.        use this program, or for any claim by any other party.
  307.  
  308.        This warranty is governed by the laws of the State of Idaho.
  309.  
  310.  
  311.                               REGISTRATION FORM
  312.                               -----------------
  313.  
  314.   Jackpot Poker                    Return to:  Steve Sharpe
  315.   Version 2.0                                  ATTN: Door Registration
  316.   Registration Cost: $10                       1835 Stonetree Dr.
  317.                                                Mountain Home, ID 83647
  318.  
  319.   The registration number will be sent to the address listed below:
  320.  
  321.   Name ______________________________________________________________
  322.  
  323.   Address ___________________________________________________________
  324.  
  325.           ___________________________________________________________
  326.  
  327.   Voice Phone:_______________________ Data Phone:____________________
  328.  
  329.   Enter the information below exactly as it appears in the GAME.CFG file:
  330.  
  331.   BBS Name______________________________________________
  332.  
  333.   SysOp Name____________________________________________
  334.  
  335.   Orders outside the USA add $2.00 . . . . . . . . . . . . _________
  336.  
  337.       Please find enclosed a money order for USA $_________ payable to Steve
  338.   Sharpe.  This shows my support of Shareware products and the Shareware
  339.   concept.  It also shows my encouragement to help further the development of
  340.   BBS doors.  NO PERSONAL CHECKS, PLEASE.  I've been stung too many
  341.   times!
  342.  
  343.       I understand that Jackpot Poker is provided as-is and no warranties
  344.   of any kind, expressed or otherwise, are included and that I am using it at
  345.   my own risk.
  346.  
  347.   Signed: _________________________________________  Date: _________
  348.